Xbasic

UI_DLG_IS_ACTIVE Function

Syntax

Result_Flag as L = UI_DLG_IS_ACTIVE(C title)

Arguments

Result_Flag

.T. = The dialog, or an embedded dialog within the dialog, or any control on the dialog has focus. .F. = No component of the dialog has focus.

title

The name of the dialog when created with UI_DLG_BOX() or UI_MODELESS_DLG_BOX().

Description

Is the dialog active (focus on dialog or parent).

Discussion

The UI_DLG_IS_ACTIVE() function returns .T. (True) if the dialog, or an embedded dialog within the dialog, or any control on the dialog has focus.

Example

? ui_dlg_is_active("User Message")
= .F.

Limitations

Desktop applications only.

See Also